home *** CD-ROM | disk | FTP | other *** search
/ Web Designer 98 (Professional) / WebDesigner 1.0.iso / cgi2 / download.cgi-s=ssi_image&c=txt&f=readme < prev    next >
Encoding:
Text File  |  1996-06-04  |  8.4 KB  |  169 lines
  1. ##############################################################################
  2. # SSI Random Image Displayer    Version 1.2                                  # 
  3. # Copyright 1996 Matt Wright    mattw@worldwidemart.com                      #
  4. # Created 7/1/95                Last Modified 11/4/95                        #
  5. # Scripts Archive at:           http://www.worldwidemart.com/scripts/        #
  6. ##############################################################################
  7. # If you run into any problems while trying to configure this scripts, help  #
  8. # is available.  The steps you should take to get the fastest results, are:  #
  9. #       1) Read this file thoroughly                         #
  10. #       2) Consult the Matt's Script Archive Frequently Asked Questions:     #
  11. #               http://www.worldwidemart.com/scripts/faq/                 #
  12. #       3) If you are still having difficulty installing this script, send   #
  13. #          e-mail to: scripts-help@tahoenet.com                     #
  14. #          Include any error messages you are receiving and as much detail   #
  15. #          as you can so we can spot your problem.  Also include the variable#
  16. #          configuration block that is located at the top of the script.     #
  17. #                                         #
  18. # Hopefully we will be able to help you solve your problems.  Thank you.     #
  19. ##############################################################################
  20. # COPYRIGHT NOTICE                                                           #
  21. # Copyright 1996 Matthew M. Wright  All Rights Reserved.                     #
  22. #                                                                            #
  23. # SSI Random Image may be used and modified free of charge by anyone so      #
  24. # long as this copyright notice and the comments above remain intact.  By    #
  25. # using this this code you agree to indemnify Matthew M. Wright from any     #
  26. # liability that might arise from it's use.                                  #  
  27. #                                                                            #
  28. # Selling the code for this program without prior written consent is         #
  29. # expressly forbidden.  In other words, please ask first before you try and  #
  30. # make money off of my program.                                              #
  31. #                                                                            #
  32. # Obtain permission before redistributing this software over the Internet or #
  33. # in any other medium.  In all cases copyright and header must remain intact.#
  34. ##############################################################################
  35.  
  36. This script is provided to allow you to have a random image appear on your 
  37. page every time it is reloaded.  The server side includes version offers you 
  38. link flexibility as well as coinciding random alt text and other variables 
  39. which make it slightly more advanced than the Basic Random Image Displayer.
  40.  
  41. There are two files included with this script.
  42.         1) README - This file, which explains installation
  43.         2) ssi_rand_image.pl - The perl script which chooses the random image.
  44.  
  45. Below is a list of the changes that must be made to the ssi_rand_image.pl file 
  46. in order for it to choose your random images correctly:
  47.  
  48. Inside the script you will see a list of variables, which must be defined in 
  49. order for your script to work.  Below is a description of how to define each 
  50. one:
  51.  
  52. $basedir = "http://your.host.xxx/path/to/images/";
  53.  
  54.         The standard portion of my url for each image.  This is the base 
  55. location of each image that is referenced in the next array @images. The 
  56. random image name chosen out of @images will be appended later on in the 
  57. script to form a complete url.
  58.  
  59. @images = ("first_image.gif","second_image.jpg","third_image.gif");
  60.  
  61.         This is the name of each image.  They can be whatever format you would 
  62. like, just make sure that when each of these filenames is appended to 
  63. $basedir, they form a complete url path to the image.
  64.  
  65. @urls = ("http://url_linked/to/first_image",
  66.          "http://url_linked/to/second_image",
  67.          "http://url_linked/to/third_image");
  68.  
  69.         If you want each image to be accompanied with a link, then this is 
  70. your chance to do it.  If you leave a field blank, then the script will assume 
  71. you do not have a url for that image and it will not link the image to 
  72. anything.  So therefore, if you did not have a link for the second image in 
  73. the example above you could do:
  74.  
  75.         @urls = ("http://url_linked/to/first_image",
  76.                  "",
  77.                  "http://url_linked/to/third_image");
  78.  
  79. @alt = ("First WWW Page","Second WWW Page","Third WWW Page");
  80.  
  81.         This is the same idea as the @urls array.  Each of these alt text fields 
  82. corresponds to the image located in the same array spot in @images, as well 
  83. as the same url located in the @urls array.  If you don't want the alt text 
  84. for a certain image just leave the field blank as in the example of @urls 
  85. above.
  86. ---
  87.  
  88. There are also a number of options that you will need to define and decide 
  89. whether to use.  They are located directly below the variables in the 
  90. ssi_rand_image.pl script.
  91.  
  92. $uselog = "1";            # 1 = YES; 0 = NO
  93.  
  94.         At this point you must decide whether or not you want to use the 
  95. logging feature.  for most practical purposes this will not be used, but some 
  96. people may find it helpful either for keeping stats or seeing which images get 
  97. picked the most.  All the logging feature will record is the image, date, and 
  98. remote host that saw the image.  Should you choose to turn this option on, you 
  99. will need to define two more variables:
  100.  
  101.    $logfile = "/home/mattw/public_html/links/ssi_image";
  102.                 The location of the log file.  This must be in a 
  103.         readable/writable directory and given read/write permissions for all 
  104.         users so that the server's uid may edit the log file.
  105.    $date = `/usr/bin/date`; chop($date);
  106.                 This is the location of your date function enclosed in '`' so 
  107.         that it will be executed when it is called upon.  It returns the date 
  108.         function for logging purposes only.
  109.  
  110. $link_image = "1";        # 1 = YES; 0 = NO
  111.  
  112.         If you turn this variable off you do not need to worry about what is 
  113. in the @urls variable.  It simply won't link any of your images.
  114.  
  115. $align = "left";
  116.  
  117.         This is the way in which you want your image aligned.  Valid choices 
  118. for Netscape include: left, right, middle, absmiddle, bottom, and absbottom.
  119.  
  120. $border = "2";
  121.  
  122.         This is the size you want your border to be.  Mainly occurs when you 
  123. have images linked the border turns blue, and in Netscape you can control the 
  124. size.  Setting this to zero causes there to be no border.
  125.  
  126. You can turn off both align and border by setting them equal to "" like:
  127. $align = ""; or $border = "";
  128. _____________________________________________________________________________
  129.  
  130. Server Side Includes
  131.  
  132. I hope that you already know how to accomplish a Server Side Includes, and 
  133. therefore I am not going to go into detail about how.  Two things you can 
  134. check for are:
  135.  
  136. 1) Ask your sysadmin if you have access to server side includes and what you 
  137. need to change about your file to make them work.  This often involves 
  138. changing your .html files to .shtml.
  139.  
  140. 2) If you really don't know anything about Server Side Includes, you can 
  141. check out a great tutorial that NCSA has developed;  located at:
  142.  
  143.         http://hoohoo.ncsa.uiuc.edu/docs/tutorials/includes.html
  144.  
  145. ________________________________________________________________________
  146.  
  147. HISTORY:
  148. Version 1.1:    9/30    - Corrections made to random image displayer to 
  149.               add functionality of alt text, links, etc... 
  150.               to each random image..
  151. Version 1.2:    11/4    - Errors in alt="" tag not being noticed 
  152.               correctly, and spacing being messed up fixed!
  153.  
  154. ________________________________________________________________________
  155.  
  156. The Random Image Script was written to be useful, and comes with no 
  157. warranties, express or implied.  You can use this script freely, however you 
  158. want.  You can modify it however you like, I would just ask two things:
  159.  
  160. 1) Register it with me when you use it:  This means send me the url of where 
  161. it is implemented.  It can be done through the on-line form located at:
  162.         http://worldwidemart.com/scripts/implement.html
  163.  
  164. 2) Keep my name in the scripts (and possibly on the html page) somewhere.
  165.  
  166. And last of all, ENJOY THE SCRIPT!
  167. _____________________________________________________________________________
  168. Matt Wright - mattw@worldwidemart.com - http://www.worldwidemart.com/scripts/
  169.